home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: The RISC OS Graphics CD / Acorn User: The RISC OS Graphics CD.iso / utilities / multiscrn / _multiscrn / _help < prev    next >
Encoding:
Text File  |  1993-10-05  |  11.0 KB  |  236 lines
  1.                                    !MultiScrn
  2.                                    ==========
  3.  
  4.                             © 1993 Michael R. Ellis
  5.  
  6. How to use !MultiScrn
  7. =====================
  8.  
  9.         !MultiScrn provides up to ten views of the RISC OS desktop.  Each view
  10. can be displayed singly,  or all ten views can be displayed simultaneously.  It
  11. is also possible to remove all windows so that pinboard items can be accessed
  12. easily.
  13.  
  14.         When !MultiScrn is first started it selects the first view,  known as
  15. "Screen 1",  and all the windows visible are automatically placed onto this
  16. screen.  A row of buttons is added to the iconbar,  and it is through these
  17. that other screens may be selected.
  18.  
  19.  
  20. Basic Operation
  21. ===============
  22.  
  23.         !MultiScrn can operate in three distinct modes,  namely Selected,  All
  24. and None. The names are pretty self-explanatory - Selected mode displays the
  25. selected screen while All and None modes are used to display, respectively, 
  26. all and none of the available screens.
  27.  
  28.         When first started,  !MultiScrn is in the Selected mode.  To select a
  29. different screen you can either double-click Select over one of the buttons
  30. above the iconbar or,  alternatively,  you can use ⇧^f1 (Shift-Control-f1) to
  31. ⇧^f10 to select screen 1 to 10 respectively.  In Selected mode,  each screen
  32. can have a different screen mode and palette which will be set up when that
  33. screen is selected.  To change the screen mode and/or palette, simply use the
  34. palette application (or any other,  similar utility) as normal.  To override
  35. the automatic mode and palette change hold down Control while double-clicking
  36. the appropriate button - it is not possible to override the mode change when
  37. using the keyboard shortcuts.
  38.  
  39.         Double-clicking on the currently depressed button will change
  40. !MultiScrn into None mode.  While in None mode all windows will be moved off
  41. screen,  the screen mode and palette will remain unchanged and any windows
  42. created will be assigned to the screen in effect before None mode was entered.
  43.  
  44.         Double-clicking any button with Adjust or pressing ⇧^f11 will change
  45. !MultiScrn in All mode - the screen mode and palette will be those in effect
  46. when All mode was entered.  Any windows created while in All mode will be
  47. assigned to all the screens.
  48.  
  49.         Clicking Menu over the buttons produces a menu which can give
  50. information about !MultiScrn,  quit !MultiScrn or change the text displayed in
  51. the button: !MultiScrn will automatically shorten the name to fit the available
  52. space if necessary.
  53.  
  54.  
  55. Advanced Operation
  56. ==================
  57.  
  58. Moving Windows around
  59. ---------------------
  60.  
  61.         There comes a time when you want to move a window from one screen to
  62. another,  and !MultiScrn allows you to do this in several different ways which
  63. are outlined below.  All of the operations are based upon the filer methods of
  64. moving and copying files around - it is much easier to understand the
  65. descriptions if this is remembered.
  66.  
  67.         Moving a single window is always done by dragging from a button on the
  68. button-bar to a window.  Two things must also be remembered.  First, there is
  69. only ever one copy of a window - if that copy is closed (using the normal
  70. 'close' icon on the window) then the window will disappear from all the screens
  71. it appeared on.  Second,  iconised windows,  backdrop windows and panes are
  72. never affected by !MultiScrn.
  73.  
  74.         Dragging with Select copies the window to the screen associated with
  75. the button.  This is similar to the method used by the filer to copy a file
  76. from one place to another except that the drag occurs in the 'wrong' direction.
  77.  
  78.         To move a window to a specific screen,  shift-drag with Select just as
  79. if you were going to copy a window as described above.  The window will
  80. disappear from all the screens it appears on and will re-appear on the
  81. destination screen.
  82.  
  83.         Dragging with Adjust instead will copy the window onto all the screens.
  84. Shift-dragging with Adjust will attempt to remove the window from the currently
  85. displayed screen.  Note that !MultiScrn will not allow you to remove the window
  86. from the last screen it appears on.
  87.  
  88. Moving Screens around
  89. ---------------------
  90.  
  91.         It is possible to move all the windows on a screen to another screen by
  92. dragging between two buttons on the button-bar.  Dragging and shift-dragging
  93. with Select both work as expected - the former copies all the windows while the
  94. latter moves the windows.  Note that in this case the drag works 'right way
  95. round' - the windows are copied/moved from the screen you drag from and to the
  96. screen you drag to.
  97.  
  98.         Dragging and shift-dragging with Adjust is a little more complicated. 
  99. The former moves any window which currently appears on all screens to all
  100. screens,  the net result of which is that it does nothing!  The latter moves
  101. any window which currently appears on all screens to the destination screen.
  102.  
  103. Command-line Operation
  104. ----------------------
  105.  
  106.         To ease the setting up of screens,  a means is provided whereby the
  107. currently selected screen and the names of any of the screens may be set from
  108. the command line or an 'Obey' file.  This is done by the "WIMP Messenger"
  109. module included with MultiScrn.  The commands recognised are :-
  110.  
  111. SendMessage MultiScrn Name <screen> <name>
  112. SendMessage MultiScrn Set  <screen>
  113.  
  114. where <screen> is a number between 1 and 10 (out of range values are ignored)
  115. and <name> is a text string to be used as the name.  The "Set" command also
  116. understands the screen known as 'all'.
  117.  
  118. Note that there is a "bug" (feature) in all current version of the RISC OS
  119. filer which prevents the Filer_OpenDir and Filer_CloseDir commands from working
  120. properly within scripts: all Filer_ commands are "saved up" until the end of
  121. the obey script and are then executed in reverse order.  This means that...
  122.  
  123. SendMessage MultiScrn Set 1
  124. Filer_OpenDir adfs::0.$.Dir1
  125. SendMessage MultiScrn Set 2
  126. Filer_OpenDir adfs::0.$.Dir2
  127.  
  128. ...will actually open both Dir1 and Dir2 on screen 2 with Dir1 on top of Dir2. 
  129. Sorry,  but there really is nothing I can do about this without re-writing the
  130. entire filer.
  131.  
  132.  
  133. Known Bugs and 'Features'
  134. =========================
  135.  
  136.         !MultiScrn assumes that you have the wimpflags (set using !Configure or
  137. the "*configure wimpflags" command) set to allow windows to be dragged off the
  138. right and bottom of the visible screen.
  139.  
  140.  
  141. Acknowledgements and Historical Information
  142. ===========================================
  143.  
  144.         The original idea for !MultiScrn can be traced back to the excellent
  145. "screen" program in the UNiX (® AT&T Labs) public domain:  screen allows the
  146. user to switch quickly between up to ten different tasks on a single textual
  147. terminal with a couple of keystrokes.  While this approach is not really valid
  148. in a graphical environment,  the principal was extended in several of the
  149. X-Windowing System window managers (in particular MOTiF and Open-Look Windows)
  150. which implement a system of "rooms" for the various windows.
  151.  
  152.         The Archimedes followed with the excellent !Larger,  which allowed the
  153. idea of "rooms" coupled to a large,  scrolling virtual desktop.  However, 
  154. after only a relatively brief exposure to !Larger,  I found the virtual desktop
  155. to be rather confusing:  it seemed very easy to lose a window,  and the
  156. familiarity I had with the UNiX "screen" program was missing.
  157.  
  158.         !MultiScrn is my answer to the problem - it implements "rooms",  called
  159. "screens",  without the complexity and confusion surrounding the virtual
  160. desktop.  Hot keys are provided to switch quickly between various screens even
  161. when the button bar is hidden,  and it is possible to move all the windows
  162. off-screen so as to reveal all the items pinned to the pinboard.
  163.  
  164.         !MultiScrn is written using some functions from DeskLib,  a FreeWare
  165. RISC OS Wimp library moderated by Jason Williams.
  166.  
  167.         The WIMPMessenger module was written by Michael R. Ellis and is similar
  168. in operation to the "Dialogue" module provided with StrongEd II (V2.50) by
  169. Guttorm Vik/Stallion Software.  WIMPMessenger was written from scratch and has
  170. several improvements over the Dialogue module.
  171.  
  172.         Thanks to Simon Lockhart for many suggestions and ideas,  some of which
  173. have been included in this version of !MultiScrn.  Simon also found a few small
  174. bugs in !MultiScrn,  but I'm not going to thank him for that! (-:
  175.  
  176.         "!Larger",  by Robin Watts,  has now moved into the commercial domain.
  177.  
  178. Version History
  179. ===============
  180.  
  181. 0.xx    18/07/93        Prototype versions - many with bugs and/or missing
  182.      to 08/08/93        features.  None were released.
  183.  
  184. 1.00    10/08/93        New version,  completely re-written and greatly improved
  185. 1.01    11/08/93        Some small bugs fixed.
  186. 1.02    31/08/93        Added the facility to have a window on all screens.
  187. 1.03    01/09/93        Improved the action on QUIT and upon multiple invocation
  188. 1.04    04/09/93        Added WIMPMessenger facilities.
  189. 1.05    08/09/93        Minor bug fixed - "thanks" Si!!!
  190. 1.06    13/09/93        Changed the user interface and added facilities for a
  191.                         window to appear on an arbitary set of screens.
  192.                         First official release version.
  193.  
  194.  
  195. Author's Note and Licence
  196. =========================
  197.  
  198.         The code and other files of !MultiScrn remain the copyright © 1993 of
  199. the author,  Michael R. Ellis.  No part of the code nor the supporting files
  200. may by modified in any way without the prior written permission of the author. 
  201. No warranty,  express or implied,  is given with this software - you use it at
  202. your own risk.
  203.  
  204.         However,  this licence allows the distribution of !MultiScrn in an
  205. unaltered form as FreeWare by anyone provided that :-
  206.  
  207.   *     No charge is levied other than reasonable cost to cover
  208.         distribution and/or copying costs.  I regard more than £2 (or local
  209.         equivalent) as unreasonable (1993 prices).
  210.  
  211.   *     All files in the !MultiScrn directory are provided unaltered.
  212.  
  213.         WIMPMessenger is freeware in its own right and may be used in your own
  214. products provided that it is acknowledged in the !Help file of the application
  215. and that the application is distributed as FreeWare.  WIMPMessenger may not be
  216. used in commercial applications.  It is strongly recommended that the first
  217. parameter in any command issued via WIMPMessenger is the name of the
  218. application and that any application recognising the name should claim the
  219. message to prevent multiple actions from a single command.
  220.  
  221.         Bug reports and comments may be sent to me at the address below - I
  222. will attempt to fix any bugs found and incorporate any good ideas for
  223. improvements,  but I can make no promises.  If you supply a blank,  E-formatted
  224. disc and a post-paid reply envelope,  I will return your disc with the most up
  225. to date version of !MultiScrn and any other FreeWare products I have written. 
  226. My address is :-
  227.  
  228.                                 Michael R. Ellis,
  229.                                  33, Barnfield Avenue,
  230.                                   Kingston upon Thames,
  231.                                    Surrey,  KT2 5RD,
  232.                                     England.
  233.  
  234. Note: The Author can also be contacted by eMail:
  235.         mikee@dd.eng.bbc.co.uk
  236.